home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 3 / Cream of the Crop 3.iso / editor / gb11.zip / GBROWSE.DOC < prev    next >
Text File  |  1993-11-13  |  18KB  |  544 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                               Graphics Browser 1.1
  12.  
  13.                                  Copyright 1993
  14.  
  15.                               All Rights Reserved
  16.  
  17.                           New-Ware Shareware Products
  18.                                8050 Camino Kiosco
  19.                               San Diego, CA 92122
  20.                                  (619) 455-6225
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.                                  Contents
  34.  
  35.  
  36.           1  Disclaimer  . . . . . . . . . . . . . . . . . . . . . . .  2
  37.           2  What is Graphics Browser? . . . . . . . . . . . . . . . .  2
  38.           3  About Shareware . . . . . . . . . . . . . . . . . . . . .  2
  39.           4  How To Register . . . . . . . . . . . . . . . . . . . . .  3
  40.           5  The New-Ware BBS  . . . . . . . . . . . . . . . . . . . .  4
  41.           6  Operating Graphic Browser . . . . . . . . . . . . . . . .  5
  42.              6.1  The Main Menu  . . . . . . . . . . . . . . . . . . .  5
  43.                 6.1.1  The Files Menu  . . . . . . . . . . . . . . . .  5
  44.                 6.1.2  The Windows Menu  . . . . . . . . . . . . . . .  5
  45.                 6.1.3  The Block Ops Menu  . . . . . . . . . . . . . .  6
  46.                 6.1.4  The Help Menu . . . . . . . . . . . . . . . . .  6
  47.              6.2  The Command/Status Line
  48.                                          . . . . . . . . . . . . . . .  7
  49.              6.3  Command Line File Loading  . . . . . . . . . . . . .  7
  50.              6.4  The Auto-Scroll Feature  . . . . . . . . . . . . . .  8
  51.              6.5  About GBROWSE.HLP  . . . . . . . . . . . . . . . . .  9
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.                                        i
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.   1  Disclaimer
  86.  
  87.  
  88.        New-Ware hereby disclaims all warranties relating to this product,
  89.   whether express or implied, including without limitation any implied
  90.   warranties of merchantability or fitness for a particular purpose. New-Ware
  91.   cannot and will not be liable for any special, incidental, consequential,
  92.   indirect or similar damages due to loss of data or any other reason, even if
  93.   New-Ware or an authorized New-Ware agent has been advised of the possibility
  94.   of such damages.  In no event shall the liability for any damages ever
  95.   exceed the price paid for the license to use software, regardless of the
  96.   form and/or extent of the claim.  The user of this program bears all risk as
  97.   to the quality and performance of the software.
  98.  
  99.  
  100.   2  What is Graphics Browser?
  101.  
  102.  
  103.        Graphics Browser, hereafter known as GB for short, is a powerful
  104.   multiple-file browser that is operated through a DOS Graphics User Interface
  105.   (GUI).  It permits up to 9 different text files to be loaded into 9
  106.   different moveable/sizeable windows and it supports the loading of multiple
  107.   files from the command line or from a list file.
  108.  
  109.        This version of GB requires a VGA graphics card that supports at least
  110.   16 colors and a mouse is strongly recommended.  Future versions of GB may
  111.   incorporate Hercules monochrome graphics support.
  112.  
  113.  
  114.   3  About Shareware
  115.  
  116.  
  117.        GB is Shareware. Shareware is NOT free.  It is computer software
  118.   offered for sale at a set price and the only real difference between
  119.   Shareware and other commercial software products is the method of
  120.   distribution and the important "try before you buy" feature.  With Shareware
  121.   you are normally licensed by the owner/author of the program to operate the
  122.   Shareware distribution copy on a trial basis.  Then if you like it and make
  123.   regular use of it, you are bound to pay for it.
  124.  
  125.        Users are licensed to operate Graphics Browser on their personal
  126.   computers for the purpose of test and evaluation on a trial basis for a
  127.   limited trial period.  It is not possible to reasonably define any
  128.   definitive limits of a fair and equitable time period for evaluation,
  129.   therefore it is left to the user's judgment and sense of fair play as to the
  130.   time required to make a decision as to its usefulness.  If the user decides
  131.   the program is not of sufficient merit to warrant purchase through
  132.   registration with New-Ware, the program should be removed from his or her
  133.  
  134.  
  135.  
  136.                                      - 2 -
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.   personal computer.  Otherwise, if the program is deemed useful and is in
  144.   regular use on the user's personal computer system, registration with New-
  145.   Ware is required.
  146.  
  147.        Registered users are those users that find the program useful and pay
  148.   for GB by registering that payment with New-Ware.  By virtue of registration
  149.   and payment for the program, registered users are granted a license to
  150.   continue to utilize the program on their personal computer for as long as
  151.   they choose.  This license authorizes the user to use the program on any
  152.   personal computer system he or she may own so long as the program is
  153.   operated on only one computer system at a time.
  154.  
  155.        Site licenses for use of GB on multiple computers are available upon
  156.   request at a reduced fee that is based on the number of single machines
  157.   licensed for use.
  158.  
  159.  
  160.   4  How To Register
  161.  
  162.  
  163.        There is no functional difference between the Shareware distribution
  164.   version of GB and the registered version save the absence of the opening
  165.   Shareware screen in the registered version.
  166.  
  167.        The price of GB is $20.00.  You may register GB in one of three ways:
  168.  
  169.             1) By mail with check or money order to:
  170.  
  171.                            New-Ware
  172.                            8050 Camino Kiosco
  173.                            San Diego, CA 92122-1820
  174.  
  175.             2) By telephone with Visa/Mastercard to:
  176.  
  177.                            New-Ware
  178.                            (619) 455-6225
  179.                            Business hours ONLY please!
  180.                            Monday thru Friday
  181.                                 8 a.m. to 5 p.m. Pacific Time
  182.                            Saturday
  183.                                 8 a.m. to 1 p.m. Pacific Time
  184.  
  185.             3) Electronically through the New-Ware BBS:
  186.  
  187.                            New-Ware BBS
  188.                            (619) 455-5226
  189.                            24 Hours per day
  190.                            7 Days per week
  191.  
  192.  
  193.  
  194.                                      - 3 -
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.        Special site license rates for licensing multiple copies of GB are
  202.   available.  Please license fee schedule information.
  203.  
  204.        Foreign (non-US/Canada) orders must include a $2.00 special handling
  205.   fee in addition to the $20.00 registration fee.  Also, no checks on banks
  206.   located outside the United States will be accepted unless the check is able
  207.   to clear with a U.S. based branch.
  208.  
  209.        California residents MUST include state sales tax with their order.
  210.  
  211.        This Shareware version of Graphics Browser may be freely copied and
  212.   passed on to other individual users for their evaluation.  Disk vendors
  213.   and/or distributors that desire to distribute Graphics Browser must adhere
  214.   to the guidelines presented in VENDOR.DOC.  Under no circumstance may
  215.   Graphic Browser be used in conjunction with a system to retrieve and/or view
  216.   (browse) files contained on a CD-ROM.
  217.  
  218.        Press Alt+R or select "Registration" from the Help menu to invoke an
  219.   interactive registration form.  All pertinent information may be entered
  220.   into the dialog and then sent to the printer as a registration form.
  221.  
  222.        Upgrades to later versions are available to registered users on the
  223.   New-Ware BBS at no cost.  Access to the BBS is a privilege granted by New-
  224.   Ware that may be revoked at any time for any reason.  Those who request
  225.   upgrades via telephone or mail must remit a $5.00 charge for an upgrade.
  226.  
  227.  
  228.   5  The New-Ware BBS
  229.  
  230.  
  231.        New-Ware Shareware Products BBS
  232.  
  233.        (619) 450-3257 - Node #1 1200/2400/9600/14400  PPI 14000FXMT
  234.              455-5226 - Node #2 1200/2400 (9600 HST)  US Robotics HST
  235.  
  236.        The New-Ware Shareware Products BSS operates 24 hours per day, 7 days
  237.   per week.  Node #1 is dedicated to registered users only.  Nodes #2 is open
  238.   to all callers.  Users that register via the BBS receive access to the
  239.   latest registered version within 1 business day after leaving their credit
  240.   card data.  Users who register by mail or phone may also access the
  241.   registered version by BBS, but you MUST log on and leave a comment to the
  242.   sysop to the effect that you are a registered user and desire access.  The
  243.   author can also be contacted on CIS via PPN 71535,665 (please use EMAIL).
  244.   The BBS also serves as an avenue for product support.  You may report
  245.   problems or ask questions about the operation of GB via the message facility
  246.   of the BBS.
  247.  
  248.  
  249.  
  250.  
  251.  
  252.                                      - 4 -
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.   6  Operating Graphic Browser
  260.  
  261.  
  262.        The GB GUI is easy and intuitive to use and all GB commands are defined
  263.   in the help file.  The help file can be viewed at any time by pressing the
  264.   F1 key or selecting the "Commands" item from the Help menu.
  265.  
  266.   6.1  The Main Menu
  267.  
  268.        The top line of the display contains the main GB menu.  Any menu can be
  269.   activated by pressing the Alt key plus the highlighted character in the menu
  270.   name or by clicking on the name with the mouse.  Use the mouse or arrow keys
  271.   to select a menu item and the Enter key or mouse click to invoke the
  272.   selected item.  Use the Esc key to exit a menu with no action.
  273.  
  274.   6.1.1  The Files Menu
  275.  
  276.        The Files menu consists of the following commands:
  277.  
  278.             Open      -    F3
  279.             Close     -    Esc
  280.             Chg Dir   -    F2
  281.             DOS Shell
  282.             Exit      -    Alt+X
  283.  
  284.        The "Open" command activates a file selection dialog that displays the
  285.   file names from the current directory.  You may change directories in this
  286.   dialog or by selecting the "Chg Dir" command.  The "Chg Dir" command invokes
  287.   a directory tree dialog in which a new default directory can be set.  Use
  288.   the "DOS Shell" command to temporarily drop to DOS.  The "Close" command
  289.   will close the active window and Alt+X will exit the program.
  290.  
  291.   6.1.2  The Windows Menu
  292.  
  293.        The Windows menu commands control the open file windows:
  294.  
  295.             Size/Move -    Ctrl+F5
  296.             Zoom      -    F5
  297.             Next      -    F6
  298.             Previous  -    Shift+F6
  299.             Close     -    Esc/Atl+F3
  300.             List      -    Alt+0
  301.             Save      -    Alt+S
  302.             Delete    -    Alt+D
  303.  
  304.        The "Size/Move" command can be used by non-mouse users to move and/or
  305.   size the current window.  After moving/sizing, press the Enter key to
  306.  
  307.  
  308.  
  309.  
  310.                                      - 5 -
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.   preserve the current window position/size or press the Esc key to return the
  318.   window to its original position.
  319.  
  320.        A window may be toggled to zoom to occupy the full screen area or zoom
  321.   back to its original size.
  322.  
  323.        The "Next" and "Previous" commands make the next or previous window on
  324.   the window list active.
  325.  
  326.        A list of active windows can be activated via the "List" command.  You
  327.   may select a window from this list to close (delete) or to make active.
  328.  
  329.        GB supports loading files according to file names stored in a text
  330.   file.  The "Save" command will store the full path names of all the files
  331.   currently being viewed in a text file named GBROWSE.LST in the current
  332.   directory.  The "Delete" command will delete this file if it exists.
  333.  
  334.   6.1.3  The Block Ops Menu
  335.  
  336.        A block of text anywhere in a viewed file may be marked for writing to
  337.   another file or for printing.  The commands are:
  338.  
  339.             Mark      -    F9
  340.             Clear     -    Ctrl+H
  341.             Print     -    Ctrl+P
  342.             Write     -    Ctrl+W
  343.  
  344.        To mark a block of text, move the window cursor bar to the first line
  345.   of the block and press F9 or the right mouse button.  Then move the cursor
  346.   bar to the last line of the block and do the same.  Marked text is displayed
  347.   in a highlighted color.  A block may be cleared (unmarked) by pressing
  348.   Ctrl+H.
  349.  
  350.        The "Print" command will invoke a dialog box that displays the first
  351.   and last line numbers of the block and a reminder to make sure that the
  352.   printer is on-line and ready.
  353.  
  354.        When writing a block to a file with the "Write" command, a dialog box
  355.   appears in which you are to enter the file name of the target file.  If this
  356.   file exists, you will be given the opportunity to overwrite the file, append
  357.   to the file, or to cancel the operation.
  358.  
  359.   6.1.4  The Help Menu
  360.  
  361.        A help window containing brief descriptions of all the GB commands is
  362.   accessed via the "Commands" item.  The "About" item displays a window that
  363.   contains version and other information.
  364.  
  365.  
  366.  
  367.  
  368.                                      - 6 -
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.        Use the "Register" command to fill out an automated registration form
  376.   for mailing to New-Ware.
  377.  
  378.   6.2  The Command/Status Line
  379.  
  380.        The bottom line of the display is occupied by a command line that
  381.   indicates the functions of the some of the more frequently used commands.
  382.   Activate a command by pressing the indicated function key or by clicking on
  383.   the command key with the mouse.
  384.  
  385.             F4        -    Goto #
  386.             F5        -    Zoom
  387.             F6        -    Next
  388.             F7        -    Show #
  389.             F8        -    Search
  390.             F9        -    Mark Blk
  391.  
  392.        Use the "Goto #" command to jump the cursor bar to any line number in
  393.   the file.
  394.  
  395.        The "Zoom" command is a toggle that alternates between normal and full
  396.   screen window size.
  397.  
  398.        The "Next" command makes the next window on the master window list the
  399.   active window.
  400.  
  401.        Line numbers can be displayed at the left margin of the file window and
  402.   the "Show #" command is toggles the line number display function on and off.
  403.  
  404.        The "Search" command prompts you for a string to enter as a target for
  405.   a complete search of the file in the active window.  The search dialog also
  406.   offers an option to use a case sensitive search and an option to start the
  407.   search at the current cursor position or at the top of the file.  The target
  408.   search string is limited to 30 characters in length.  If a match is found,
  409.   the cursor bar is positioned to the line where the string was found.  Press
  410.   Ctrl+L to continue the search.
  411.  
  412.        The "Mark Blk" command is used to mark the first and last lines of a
  413.   block of text in the file.
  414.  
  415.   6.3  Command Line File Loading
  416.  
  417.        GB provides a great deal of flexibility in loading text files on the GB
  418.   DOS command line.  One method is to start GB with up to 9 file names on the
  419.   command line, as in the following example:
  420.  
  421.        GB.EXE FILE.TXT ANOTHER.DAT C:\UTIL\MYFILE.DOC F:\DOC\NAME.TXT
  422.  
  423.  
  424.  
  425.  
  426.                                      - 7 -
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.        Another option is to include a file specification on the command line
  434.   that contains DOS wildcards.  For example, the command:
  435.  
  436.        GB.EXE AFILE.TXT *.BAK
  437.  
  438.   Will first load AFILE.TXT and then it will load each file in the current
  439.   directory that has an extension of BAK until 9 total files are loaded or
  440.   there are no more .BAK files to load.
  441.  
  442.        A third option is to place a text file named GBROWSE.LST in the
  443.   directory from which you call GB.EXE.  If GB finds this file when it
  444.   executes, it will open it and treat each line in the file as a file name to
  445.   load.  For example, suppose you are starting GB from a directory named
  446.   D:\TEXT and this directory contains a file named GBROWSE.LST that contains
  447.   the following lines:
  448.  
  449.        AFILE.TXT
  450.        E:\DOCS\MYDOC.DOC
  451.        THENAME.DAT
  452.  
  453.   GB will attempt to load each of these files into successive windows.  Just
  454.   remember that the maximum number of file windows that can be loaded at one
  455.   time is 9.
  456.  
  457.        You can also mix and match the above options.  For example, the
  458.   command:
  459.  
  460.        GB MYTEXT.TXT ??CD.DAT
  461.  
  462.   executed in a directory that contains GBROWSE.LST as defined above will
  463.   cause GB to load the three files in GBROWSE.LST first, then MYTEXT.TXT, and
  464.   finally all files matching ??CD.DAT until 9 total files have been loaded.
  465.  
  466.        GBROWSE.LST may be created by loading several files and pressing Alt+S
  467.   to save the file in the active directory.
  468.  
  469.   6.4  The Auto-Scroll Feature
  470.  
  471.        BG provides an automatic text scrolling feature that will scroll the
  472.   text of the active file down through the file at a user-controlled rate.  To
  473.   activate this feature, press Alt+A.  The scroll speed can be controlled
  474.   during the scroll with the Up/Down Arrow keys.  Pressing the Up Arrow slows
  475.   down the scroll rate and pressing the Down Arrow speeds it up.  The scroll
  476.   can be stopped by pressing Alt+A, the Space Bar, or the Esc key.
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.                                      - 8 -
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.   6.5  About GBROWSE.HLP
  492.  
  493.        GBROWSE.HLP is a standard ASCII text file that is loaded and displayed
  494.   by GB when the help function is invoked.  The user may add personalized help
  495.   lines to this file or modify the current lines as desired.  To accomplish
  496.   this, simply load GBROWSE.HLP into a text editor (such as QEDIT) and make
  497.   the desired changes.  Text line length of this file is limited to 70
  498.   characters.
  499.  
  500.        GB will always attempt to load the help text file from the directory
  501.   from which GB was executed.  The best strategy in using GB is to place it in
  502.   a directory that is on the DOS path along with GBROWSE.HLP and call it from
  503.   anywhere in your system.
  504.  
  505.   Copright 1993 by New-Ware, all rights reserved.
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.                                      - 9 -
  543.  
  544.